home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xvc
/
XSGIvcSendMonitorCommand.z
/
XSGIvcSendMonitorCommand
Wrap
Text File
|
1998-10-30
|
12KB
|
199 lines
XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd((((3333)))) XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd((((3333))))
NNNNAAAAMMMMEEEE
XSGIvcSendMonitorCommand, XSGIvcSendMonitorQuery,
XSGIvcQueryMonitorBaseProtocol,
XSGIvcInitMonitorBaseProtocol - Monitor control
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<XXXX11111111////eeeexxxxtttteeeennnnssssiiiioooonnnnssss////XXXXSSSSGGGGIIIIvvvvcccc....hhhh>>>>
vvvvooooiiiidddd XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,,
iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,,
iiiinnnntttt cccchhhhaaaannnnnnnneeeellll,,,,
ccccoooonnnnsssstttt cccchhhhaaaarrrr ****mmmmoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd,,,,
iiiinnnntttt ccccoooommmmmmmmaaaannnnddddLLLLeeeennnnggggtttthhhh))))
SSSSttttaaaattttuuuussss XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrQQQQuuuueeeerrrryyyy((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,,
iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,,
iiiinnnntttt cccchhhhaaaannnnnnnneeeellll,,,,
ccccoooonnnnsssstttt cccchhhhaaaarrrr ****mmmmoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd,,,,
iiiinnnntttt ccccoooommmmmmmmaaaannnnddddLLLLeeeennnnggggtttthhhh,,,,
cccchhhhaaaarrrr ********mmmmoooonnnniiiittttoooorrrrRRRReeeessssppppoooonnnnsssseeee,,,,
iiiinnnntttt ****rrrreeeessssppppoooonnnnsssseeeeLLLLeeeennnnggggtttthhhh))))
iiiinnnntttt XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyMMMMoooonnnniiiittttoooorrrrBBBBaaaasssseeeePPPPrrrroooottttooooccccoooollll((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,,
iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,,
iiiinnnntttt cccchhhhaaaannnnnnnneeeellll))))
vvvvooooiiiidddd XXXXSSSSGGGGIIIIvvvvccccIIIInnnniiiittttMMMMoooonnnniiiittttoooorrrrBBBBaaaasssseeeePPPPrrrroooottttooooccccoooollll((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,,
iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,,
iiiinnnntttt cccchhhhaaaannnnnnnneeeellll))))
PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
_d_i_s_p_l_a_y Specifies the connection to the X server.
_s_c_r_e_e_n Specifies the screen of the X server.
_c_h_a_n_n_e_l Specifies the channel number.
_m_o_n_i_t_o_r_C_o_m_m_a_n_d The command to be sent to the monitor. The
command sequence must be a valid command
packet that will be sent unprocessed to the
monitor connected to cccchhhhaaaannnnnnnneeeellll.
_c_o_m_m_a_n_d_L_e_n_g_t_h The length, in bytes, of _m_o_n_i_t_o_r_C_o_m_m_a_n_d.
_m_o_n_i_t_o_r_R_e_s_p_o_n_s_e
Returns a pointer to a buffer containing the
response returned from the monitor. This
response will be returned unprocessed.
_r_e_s_p_o_n_s_e_L_e_n_g_t_h The length, in bytes, of _m_o_n_i_t_o_r_R_e_s_p_o_n_s_e.
Page 1 (printed 4/30/98)
XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd((((3333)))) XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd((((3333))))
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
These functions allow an application program to communicate
with a monitor that has the capability to send and receive
such commands. Client programs are responsible for
composing monitor commands and for parsing the result; the X
server simply transports strings between the client and
monitor.
This function is intended for server-to-monitor
communications. Servers do not guarantee that other devices
connected to the bus will function properly, nor will the
bus connecting a monitor always be active; spontaneous
messages from monitors or other devices can be ignored.
FFFFuuuunnnnccccttttiiiioooonnnnssss
XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd sends a command - for which no
response is expected - to the monitor of the specified
channel.
If a response is expected, use XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrQQQQuuuueeeerrrryyyy which
sends a command to the monitor of the specified channel and
waits for a response before continuing. The response is
placed in a buffer whose address is returned in
_m_o_n_i_t_o_r_R_e_s_p_o_n_s_e. The client is responsible for calling
XXXXFFFFrrrreeeeeeee on the memory allocated by the library.
The XXXXSSSSGGGGIIIIvvvvccccIIIInnnniiiittttMMMMoooonnnniiiittttoooorrrrBBBBaaaasssseeeePPPPrrrroooottttooooccccoooollll function must be called to
initialize the protocol the server is going to use to
communicate with the monitor before any commands or queries
are sent to the monitor. This function reinitializes the
monitor protocol each time it is called, and may be called
at any time. XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyMMMMoooonnnniiiittttoooorrrrBBBBaaaasssseeeePPPPrrrroooottttooooccccoooollll may be called to
find out if the protocol has already been initialized (see
below).
The XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyMMMMoooonnnniiiittttoooorrrrBBBBaaaasssseeeePPPPrrrroooottttooooccccoooollll function returns a
description of the protocol the X-Server will use to
communicate with the monitor. The following are defined:
_X_S_G_I_V_C__M_B_P_U_n_i_n_i_t_i_a_l_i_z_e_d
The protocol between the server and
the monitor has not yet been
initialized. Implies that the client
must first call
XXXXSSSSGGGGIIIIvvvvccccIIIInnnniiiittttMMMMoooonnnniiiittttoooorrrrBBBBaaaasssseeeePPPPrrrroooottttooooccccoooollll in order
to get a valid response.
_X_S_G_I_V_C__M_B_P_N_o_n_e The server or monitor does not support
monitor commands on this channel.
_X_S_G_I_V_C__M_B_P_A_c_c_e_s_s_B_u_s The server will use ACCESS.bus
Page 2 (printed 4/30/98)
XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd((((3333)))) XXXXSSSSGGGGIIIIvvvvccccSSSSeeeennnnddddMMMMoooonnnniiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd((((3333))))
communications protocol. The content
of message buffers referenced by
_m_o_n_i_t_o_r_C_o_m_m_a_n_d and _m_o_n_i_t_o_r_R_e_s_p_o_n_s_e
begin with ACCESS.bus primary opcode.
During its initialization, the server
will switch connected monitors from
VESA DDC1/2AB to ACCESS.bus
communications mode.
EEEEVVVVEEEENNNNTTTTSSSS
No events.
RRRREEEETTTTUUUURRRRNNNNEEEEDDDD VVVVAAAALLLLUUUUEEEE
A _B_a_d_A_c_c_e_s_s error indicates a breakdown in the monitor
protocol, and that the client must call
XXXXSSSSGGGGIIIIvvvvccccIIIInnnniiiittttMMMMoooonnnniiiittttoooorrrrBBBBaaaasssseeeePPPPrrrroooottttooooccccoooollll in order to re-establish
communications with the monitor. In addition, a _B_a_d_A_c_c_e_s_s
error will result from a send monitor command or query call
when XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyMMMMoooonnnniiiittttoooorrrrBBBBaaaasssseeeePPPPrrrroooottttooooccccoooollll has returned
_X_S_G_I_V_C__M_B_P_N_o_n_e.
For XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyMMMMoooonnnniiiittttoooorrrrBBBBaaaasssseeeePPPPrrrroooottttooooccccoooollll, see the discussion in
DESCRIPTION.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
XSGIvc
Page 3 (printed 4/30/98)